My Simple Chat Filter (WoW Classic 20주년 서버 & TBC 호환용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.6 (빌드 20506)
Version: 1.3.6 (2026. 10. 5.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Chat Filter는 무거운 라이브러리를 사용하지 않고 순수 Lua로 작성된 가볍고 강력한 채팅 필터 및 유틸리티 애드온입니다.

■ 중요한 키워드는 알림으로 받아보고, 보고 싶지 않은 키워드나 광고 도배를 무시하며, 채팅 복사, URL 복사나 자동 인사, 지원 귓속말, 거래 내역 알림 및 기록, 대화 시각 모드, 시계 패널 및 각종 타이머 같은 편의 기능을 통합하여 쾌적한 채팅 환경을 제공합니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 알림 및 무시 필터링
 - 알림 키워드: 공개, 파티찾기 등 채널 채팅에서 설정된 단어나 내 캐릭터 이름이 언급되면 소리 알림과 함께 별도의 팝업 창 Ad 돋보기를 기본 창 아래에 띄워 놓치지 않게 해줍니다. 기본 창은 항상 열려 있으며 우클릭을 통해 이동/고정을 선택할 수 있습니다.
 - 지원 귓속말: 알림 키워드 팝업 창에 뜬 캐릭터 이름을 클릭하면 미리 설정해둔 문구가 귓속말로 자동 입력됩니다. 엔터 키를 누르면 보냅니다. 현재 접속하지 않은 캐릭터를 선택해서 귓속말을 할 수도 있습니다.
 - 무시 키워드: 설정된 단어가 포함된 메시지를 채팅 창에서 숨깁니다.
 - 매크로 무시: 동일한 내용의 메시지가 N회 이상 연속으로 올라오면 자동으로 채팅 창에서 숨김니다. (5~10회 설정)

■ 자동 인사
 - 상황별 자동 인사: 설정된 인사말을 로그인했을 때 길드 채팅에, 파티나 공격대에 참여했을 때 해당 채팅에 자동으로 출력합니다. 리로드 시에 자동 인사를 반복하는 것을 막기 위한 안전 장치를 포함합니다.

■ 채팅 복사 (기본 적용)
 - 전체 채팅 복사: 각 채팅 프레임 우측 상단의 'Ctrl+A' 버튼을 누르면, 해당 채팅창의 대화 내역이 색상이나 링크 코드가 제거된 순수 텍스트로 추출되어 별도의 복사 전용 창에 나타납니다.

■ 채팅 가독성 및 시각 표시 (기본 적용)
 - 직업 색상 표시: 채팅 작성자의 이름을 직업 고유 색상으로 표시합니다.
 - 타임스탬프: 채팅 작성자 앞에 블리자드에서 제공하는 대화 시각을 [시:분], [시:분:초] 형식으로 표시하거나 비활성화합니다.
(예: [12:30:45] Goyathlay: 안녕하세요)
 - 시계 패널 및 시간측정/휴식시간/풀링 타이머: 상단 메뉴 버튼(시간측정, 휴식시간 10분/5분, 풀링 30초/15초/5초, 크기 설정), 우클릭 잠금/해제

■ URL 링크 복사 (기본 적용)
 - URL 링크 복사: 채팅창에 http나 www로 시작하는 주소가 있으면 클릭 가능한 하늘색 링크로 변환합니다. 클릭 시 주소를 바로 복사할 수 있는 팝업 창이 뜹니다.

■ 팝업 창 높이 조절
 - URL 복사, Ad 돋보기, CHAT 복사 팝업 창의 높이는 창 우측 상단의 '높이' 버튼을 통해 조절할 수 있습니다. (총 6단계로 출력 줄 수는 1~25)
 - 기본 높이는 URL 복사 1단계, Ad 돋보기 2단계, CHAT 복사 3단계로 각각 다르게 설정되어 있습니다. 거래 기록은 단계 구분 없이 400으로 고정되어 있습니다.

■ 거래 알림
 - 상세 거래 보고: 거래가 완료되면 내가 대상에게 무엇을 주거나 받았는지를 귓속말로 즉시 알립니다. ('<A> B 님에게 준 것은 C, 받은 것은 D' 형식, 없을 때도 포함)
 - 거래 내역은 대화 시각 활성화 여부와 상관없이 대화 시각을 표시합니다.
 - 수량 합산: 동일한 아이템을 여러 슬롯에 나누어 거래하더라도 합산하여 총량으로 표시합니다. (예시: 20개씩 2덩이, 10개 1덩이라면 50개로 표시)
 - 다중 아이템 정렬: 여러 종류의 아이템을 거래할 경우 이름을 가나다/알파벳 순서로 정렬합니다.
 - 금액 및 우선순위: 골드, 실버, 쿠퍼 단위로 표시하며, 아이템과 골드를 함께 주거나 받을 경우 아이템을 먼저 언급합니다.
 - 거래 내역을 DB에 기록하며 일부 또는 전체를 삭제할 수 있습니다.

─────────────────────────────
3. 명령어 및 사용 방법
─────────────────────────────
■ 기본 창 가이드
 - 설정 창 열기/닫기
 - Ad 돋보기 ON/OFF
 - 지원 귓속말: 알림 키워드 팝업 창에서 이름을 클릭했을 때 보낼 귓속말 문구를 캐릭터별로 설정합니다. 현재 접속 중이 아닌 캐릭터를 선택해서 문구를 설정할 수도 있고 지원 귓속말을 보낼 수도 있습니다.
 - 마우스 우클릭으로 기본 창의 이동/잠금을 설정할 수 있습니다.

■ 기본 명령어
 - /간단채팅 또는 /mscf: 설정창 열기

■ 설정 창 가이드
 - Ad 돋보기 창이 열려 있으면 그 아래에, 열려 있지 않으면 기본 창 아래에 열립니다.
 - 알림 키워드: 놓치면 안 되는 단어를 등록합니다. (본인 이름 알림 포함)
 - 무시 키워드: 보기 싫은 단어를 등록합니다.
 - 매크로 무시: 연속된 메시지 허용 횟수를 설정합니다.
 - 길드/파티 인사: 상황별(로그인, 파티나 공격대 합류) 인사말을 설정합니다.
 - 거래 알림: 거래 성공 또는 실패 시에 채팅 출력 여부를 설정합니다.

■ 키워드 관리
 - 키워드 추가: 입력 칸에 단어를 쓰고 확인을 누르면 목록에 추가됩니다.
 - 키워드 삭제: 이미 등록된 단어를 다시 입력하고 확인을 누르면 목록에서 삭제됩니다.
 - 키워드 확인: 목록을 누르면 현재 등록된 키워드들을 출력합니다.

■ 거래 알림
 - 첫 번째 드롭다운 메뉴 ON/OFF: 대상에게 귓속말로 거래 알림을 보내는 기능의 활성화 여부를 결정합니다.
 - 두 번째 체크박스 버튼 선택: 현재 파티나 공격대에 속해 있다면 귓속말 외에 해당 채팅으로도 거래 알림을 출력합니다.
 - 거래 기록: 거래 알림을 각 대상마다 시간 순서대로 항목을 매겨서 DB에 저장합니다. 설정 창에서 일부 또는 전체를 삭제할 수 있습니다.

■ 초기화
 - 설정 창 최하단의 [초기화] 버튼을 누르면 현재 접속한 캐릭터에 대한 모든 기능의 ON/OFF 상태와 저장된 키워드, 인사말 문구, 지원 귓속말 문구, 거래 기록을 모두 삭제해서 초기 상태로 되돌립니다.

─────────────────────────────
4. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.

Interface
└── AddOns
    └── MySimpleChatFilter
          ├── MySimpleChatFilter.lua
          ├── MySimpleChatFilter_TBC.toc
          ├── MySimpleChatFilter_Vanilla.toc
          └── README.txt

■ 게임 내 ‘애드온’ 탭에서 [My Simple Chat Filter]가 활성화되어 있는지 확인합니다.

─────────────────────────────
5. 주의 사항
─────────────────────────────
■ 알림 키워드와 무시 키워드가 같이 포함된 채팅이라면 키워드 우선순위에 의해 보이지 않습니다.

■ 지원 귓속말: 알림 팝업 창의 이름을 좌클릭하면 설정한 문구가 자동으로 채팅창에 입력됩니다. 마우스를 올리면 툴팁으로 안내가 표시됩니다.

■ CHAT 복사(Ctrl+A) 창이 열리면 텍스트가 자동으로 전체 선택되므로 Ctrl+C를 눌러 복사하면 됩니다.

■ 스마트 메시지 전환: 거래 내역에 아이템 링크가 포함되어 메시지가 너무 길어질 경우(약 250바이트 초과), 시스템이 자동으로 링크를 일반 텍스트로 변환하여 메시지 잘림 없이 안전하게 전송합니다.

■ 기본 창 숨기기를 체크하면 알림 키워드가 자동으로 OFF로 전환되고 고정됩니다. 기본 창 숨기기를 체크 해제하면 알림 키워드를 ON 할 수 있지만 자동으로 되지는 않습니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 1. 26.)
 - 캐릭터 이름 직업 색상, 시각 표시, URL 복사
 - 알림 키워드(팝업 창 지원 귓속말 자동완성), 무시 키워드, 매크로 무시 필터링
 - 상황별 자동 인사 출력 (리로드 시에 반복 방지)

■ 1.0.1 (2026. 1. 27.)
 - 리로드 시에 파티나 공격대 합류 자동 인사 반복 방지 수정

■ 1.1.0 (2026. 2. 27.)
 - 각 채팅 프레임별 텍스트 복사 기능 추가 (Ctrl+A 버튼 및 전용 팝업 창)
 - 드롭다운 메뉴에서 항목을 선택하면 즉시 설정하도록 수정

■ 1.2.0 (2026. 3. 11.)
 - 거래 알림(귓속말, 그룹 채팅, 기록) 기능 추가

■ 1.2.1 (2026. 3. 11.)
 - 스냅샷 갱신 타이밍으로 인한 거래 알림 메시지 오류 수정

■ 1.2.2 (2026. 3. 13.)
 - 설정 창 9행 거래 기록의 항목 간격 수정

■ 1.3.0 (2026. 3. 19.)
 - 채팅 메시지 앞에 표시하던 대화 시각을 블리자드 설정값으로 작성자 앞에 표시하도록 수정
 - 시계 패널 및 시간측정/휴식시간/풀링 타이머 추가

■ 1.3.1 (2026. 3. 21.)
 - 시계 패널 ON/OFF 버튼의 텍스트가 반대로 표시되던 오류를 수정

■ 1.3.2 (2026. 3. 22.)
 - 리로드/재접속을 하면 시계 패널이 기본 위치로 돌아가며 잠긴 상태인데도 연녹색 테두리가 보이던 오류를 수정
 - 풀링 타이머 메시지가 이중으로 나오던 것을 수정

■ 1.3.3 (2026. 9. 5.)
 - 지원 귓속말 문구 DB를 캐릭터별 설정에서 계정 공통 설정으로 수정 (현재 접속한 캐릭터로 모든 캐릭터의 문구를 관리하거나 다른 캐릭터의 문구를 선택해서 지원 귓속말 입력 가능, 초기화하면 지원 귓속말 문구는 현재 캐릭터의 것만 삭제, 기존 캐릭터별 설정의 지원 귓속말 문구는 첫 접속시에 자동으로 삭제)
 - URL 링크 복사 기능이 공격대경보에서 작동하지 않던 오류를 수정
 - 위크오라 링크 불러오기가 작동하지 않던 오류를 수정
 - Ad 돋보기 창의 부모로 기본 창을 추가 (설정 창 열기/닫기 버튼, Ad 돋보기 창 활성화 여부와 캐릭터별 지원 귓속말 관리 기능을 설정 창에서 추출)
 - 길드 (로그아웃) 자동인사 기능 삭제
 - TOC 파일 버전 수정

■ 1.3.4 (2026. 9. 7.)
 - 위크오라 링크 불러오기에서 Wago URL이 포함된 경우에 잘못된 위크오라 링크로 인식하던 오류를 수정

■ 1.3.5 (2026. 9. 15.)
 - TOC 파일 카테고리 추가

■ 1.3.6 (2026. 10. 5.)
 - 기본 창 숨기기 추가

─────────────────────────────
7. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

─────────────────────────────
8. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
